home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 22 / PC Actual CD 22.iso / linux / xfree86 / DOC / README.OpenBSD < prev    next >
Encoding:
Text File  |  1998-01-07  |  14.8 KB  |  661 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.               README for XFree86 3.3.1 on OpenBSD
  11.  
  12.                 Matthieu Herrb
  13.  
  14.             Last modified on: 26 July 1997
  15.  
  16.  
  17.  
  18. 1.  What and Where is XFree86?
  19.  
  20. XFree86 3.3.1 is a port of X11R6.3 that supports several versions of Intel-
  21. based Unix.  It is derived from X386 1.2, which was the X server distributed
  22. with X11R5.  This release consists of many new features and performance
  23. improvements as well as many bug fixes.  The release is available as source
  24. patches against the X Consortium X11R6.3 code, as well as binary distributions
  25. for many architectures.
  26.  
  27. See the Copyright Notice.
  28.  
  29. The sources for XFree86 are available by anonymous ftp from:
  30.  
  31. ftp://ftp.XFree86.org/pub/XFree86/current
  32.  
  33. Binaries for OpenBSD 2.1  are available from:
  34.  
  35. ftp://ftp.XFree86.org/pub/XFree86/current/binaries/
  36.  
  37. A list of mirror sites is provided by ftp://ftp.XFree86.org/pub/XFree86/MIRRORS
  38.  
  39. XFree86 3.3.1 also builds on other OpenBSD architectures. See section Building
  40. on other architectures (section 8.3, page 7) for details.
  41.  
  42.  
  43. 2.  Bug Reports for This Document
  44.  
  45. Send email to matthieu@laas.fr (Matthieu Herrb) or XFree86@XFree86.org if you
  46. have comments or suggestions about this file and we'll revise it.
  47.  
  48.  
  49. 3.  New features in this release
  50.  
  51.   1.  See the Release Notes for non-OS dependent new features in XFree86 3.3.1.
  52.  
  53.  
  54. 4.  Installing the Binaries
  55.  
  56. Refer to section 4 of the Release Notes  for detailed installation instruc-
  57. tions.
  58.  
  59. 4.1  Installing Xdm, the display manager
  60.  
  61. The file xc/lib/Xdmcp/WrapHelp.c is not available in France (where the binary
  62.  
  63.  
  64. README for XFree86 3.3.1 on OpenBSD
  65.  
  66.  
  67.  
  68.  
  69.  
  70. README for XFree86 3.3.1 on OpenBSD
  71.  
  72.  
  73.  
  74. distribution is built) so support for XDM-AUTHORIZATION-1 is not included here.
  75. You'll have to get WrapHelp.c and rebuild xdm after having set HasXdmAuth in
  76. host.def.
  77.  
  78. The file is available within the US; for details see ftp.x.org:/pub/R6/xdm-
  79. auth/README.
  80.  
  81. To start the display manager, log in as root on the console and type: ``xdm
  82. -nodaemon''.
  83.  
  84. You can start xdm automatically on bootup by disabling the console getty and
  85. adding the following code to /etc/rc.local:
  86.  
  87.        if [ -x /usr/X11R6/bin/xdm ]; then
  88.      echo -n ' xdm'; /usr/X11R6/bin/xdm
  89.        fi
  90.  
  91. To disable the console getty, change ``on'' to ``off'' in the console entry in
  92. /etc/ttys:
  93.  
  94.       ttyC0    "/usr/libexec/getty Pc"    pc   off secure
  95.  
  96.  
  97. 5.  Configuring X for Your Hardware
  98.  
  99. The XF86Config file tells the X server what kind of monitor, video card and
  100. mouse you have.  You must create it to tell the server what specific hardware
  101. you have.
  102.  
  103. XFree86 3.2 introduced a new, user-friendly configuration utility called
  104. XF86Setup. It has to be run as root. Refer to its documentation for details
  105. about its use.
  106.  
  107. You'll need info on your hardware:
  108.  
  109.    o Your mouse type, baud rate and its /dev entry.
  110.  
  111.    o The video card's chipset (e.g. ET4000, S3, etc).
  112.  
  113.    o Your monitor's sync frequencies.
  114.  
  115. The recommended way to generate an XF86Config file is to use the XF86Setup
  116. utility.  The xf86config text utility is still there for the (few) cases where
  117. XF86Setup can't be used. Also, there is a sample file installed as
  118. /usr/X11R6/lib/X11/XF86Config.eg, which can be used as a starting point.
  119.  
  120. For details about the XF86Config file format, refer to the XF86Config(5) manual
  121. page.
  122.  
  123. In order to protect your hardware from damage, the server will no longer read
  124. XF86Config files from a user's home directory, but requires that it be in
  125. /etc/XF86Config, /usr/X11R6/lib/X11/XF86Config.hostname or
  126. /usr/X11R6/lib/X11/XF86Config.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. README for XFree86 3.3.1 on OpenBSD
  137.  
  138.  
  139.  
  140. Once you've set up a XF86Config file, you can fine tune the video modes with
  141. the xvidtune utility.
  142.  
  143. 5.1  About mouse configuration
  144.  
  145. If your serial mouse does not work try using kermit or tip to connect to the
  146. mouse serial port and verify that it does indeed generate characters.
  147.  
  148. The OpenBSD pms driver    provides both "raw" and "cooked" (translated) modes.
  149. "raw" mode does not do protocol translation, so XFree86 would use the PS/2 pro-
  150. tocol for talking to the device in that mode.  "cooked" mode is the old Bus-
  151. Mouse translation.  By default, the driver runs in "cooked" mode.  It can be
  152. switched using ioctls or by opening the first minor device which is /dev/psm0.
  153.  
  154. 5.2  Other input devices
  155.  
  156. XFree86  supports the dynamic loading of drivers for external input devices
  157. using the XInput extension. Currently supported devices are:
  158.  
  159.    o Joystick (xf86Jstk.so)
  160.  
  161.    o Wacom tablets (Wacom IV protocol only, xf86Wacom.so)
  162.  
  163.    o SummaSketch tablets (xf86Summa.so)
  164.  
  165.    o Elographics touchscreen (xf86Elo.so)
  166.  
  167. To use a specific device, add the line
  168.  
  169.      load "module"
  170.  
  171.  
  172. in the Module section of XF86Config, where module is the name of the .so file
  173. corresponding to your device.  You also need to set up a XInput section in
  174. XF86Config.  Refer to the XF86Config(5) man page for detailed configuration
  175. instructions.
  176.  
  177. You can then change the device used to drive the X pointer with the xset-
  178. pointer(1) command.
  179.  
  180. For joystick support, you'll need to enable the joystick device driver in the
  181. kernel.  See joy(4) for details.
  182.  
  183. 5.3  Configuring PEX and XIE extensions
  184.  
  185. The PEX and XIE extensions are    supported as external modules.    If you want to
  186. have access to these extensions, add the following lines to the Module section
  187. of XF86Config:
  188.  
  189.     load    "pex5.so"
  190.     load    "xie.so"
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. README for XFree86 3.3.1 on OpenBSD
  203.  
  204.  
  205.  
  206. 6.  Running X
  207.  
  208. 8mb of memory is a recommended minimum for running X.  The server, window man-
  209. ager and an xterm take about 4 Mb of memory themselves.  On a 4Mb system that
  210. would leave nothing left over for other applications like gcc that expect a few
  211. meg free.  X will work with 4Mb of memory, but in practice compilation while
  212. running X can take 5 or 10 times as long due to constant paging.
  213.  
  214. The easiest way for new users to start X windows is to type: ``startx >&
  215. startx.log''.  Error messages are lost unless you redirect them because the
  216. server takes over the screen.
  217.  
  218. To get out of X windows, type: ``exit'' in the console xterm.  You can cus-
  219. tomize your X by creating .xinitrc, .xserverrc, and .twmrc files in your home
  220. directory as described in the xinit and startx man pages.
  221.  
  222.  
  223. 7.  Kernel Support for X
  224.  
  225. To make sure X support is enabled under  OpenBSD, the following line must be in
  226. your config file in /sys/arch/i386/conf:
  227.  
  228.      options XSERVER, UCONSOLE
  229.  
  230. The server supports the two standard  OpenBSD/i386 console drivers: pccons and
  231. pcvt. They are detected at runtime and no configuration of the server itself is
  232. required.
  233.  
  234. The pcvt console driver is now the default in OpenBSD.    It offers several vir-
  235. tual consoles and international keyboard support.
  236.  
  237. When not using XKB, the server can read the actual keymap from the keyboard
  238. driver and use to build the X keymap. Be sure to use ``RightAlt ModeShift'' in
  239. XF86Config to have the right Alt key behave as AltGr.
  240.  
  241. Syscons and codrv are not bundled with OpenBSD. They are available by anonymous
  242. FTP from a number of sites. They are not supported by the XFree86 binary dis-
  243. tribution anymore. You can compile support for them by adding -DSYSCONS_SUPPORT
  244. or -DCODRV_SUPPORT to XFree86ConsoleDefines in xf86site.def. See the section
  245. Console drivers (section 8.1, page 6) for details.
  246.  
  247. 7.1  Aperture Driver
  248.  
  249. By default OpenBSD includes the BSD 4.4 kernel security feature that disable
  250. access to the /dev/mem device when in multi-users mode. But XFree86 servers can
  251. take advantage (or require) linear access to the display memory.
  252.  
  253. The P9000, Mach64 and AGX servers require linear memory access, other acceler-
  254. ated servers can take advantage of it, but do not require it.  Some drivers in
  255. the SVGA server require linear memory access too, notably the Matrox driver.
  256.  
  257. There are two ways to allow XFree86 to access linear memory:
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. README for XFree86 3.3.1 on OpenBSD
  269.  
  270.  
  271.  
  272.   1.  Disable the kernel security feature by adding `option INSECURE' in the
  273.       kernel configuration file and build a new kernel.
  274.  
  275.  
  276.   2.  Install the aperture driver:
  277.  
  278.     1.   The first step is highly dependent from your exact operating sys-
  279.         tem version:
  280.  
  281.            o  OpenBSD 2.0
  282.  
  283.          Use the aperture driver from /usr/lkm:
  284.  
  285.          add the following lines to the end of /etc/rc.local:
  286.  
  287.                KERNDIR=/usr/lkm
  288.                if [ -f ${KERNDIR}/ap.o ]; then
  289.              modload -o ${KERNDIR}/ap -e ap -p ${KERNDIR}/apinstall ${KERNDIR}/ap.o
  290.                fi
  291.  
  292.            o  OpenBSD 2.1
  293.  
  294.          Uncomment the lines loading the aperture driver from
  295.          /etc/rc.securelevel
  296.  
  297.  
  298.     2.   Reboot your system. XFree86 will auto-detect the aperture driver
  299.         if available.
  300.  
  301.  
  302.       Warning: if you boot another kernel than    /bsd, loadable kernel modules
  303.       can crash your system. Always boot in single user mode when you want to
  304.       run another kernel.
  305.  
  306.  
  307.        Caveat: the    aperture driver only allows one access at a time
  308.        (so that the system is in the same security state once X is
  309.        launched). This means that if you run multiple servers on mul-
  310.        tiples VT, only the first one will have linear memory access.
  311.        Use 'option INSECURE' if you need more that one X server at a
  312.        time.
  313.  
  314. 7.2  MIT-SHM
  315.  
  316. OpenBSD supports System V shared memory. If XFree86 detects this support in
  317. your kernel, it will support the MIT-SHM extension.
  318.  
  319. To add support for system V shared memory to your kernel add the lines:
  320.  
  321.       # System V-like IPC
  322.       options          SYSVMSG
  323.       options          SYSVSEM
  324.       options          SYSVSHM
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. README for XFree86 3.3.1 on OpenBSD
  335.  
  336.  
  337.  
  338. to your kernel config file. Then from /sys/arch/i386/config, type:
  339.  
  340.       # rm -f ../compile/<KERNEL-NAME>/*
  341.       # config <KERNEL-NAME>
  342.       # cd ../compile/<KERNEL-NAME>
  343.       # make depend
  344.       # make
  345.  
  346. Then install your new kernel and re-boot:
  347.  
  348.       # cp /bsd /obsd
  349.       # cp bsd /
  350.       # reboot
  351.  
  352.  
  353. 8.  Rebuilding the XFree86 Distribution
  354.  
  355. The server link kit allow you to rebuild just the X server with a minimum
  356. amount of disk space.  Just unpack it, make the appropriate changes to the
  357. xf86site.def, type ``./mkmf'' and ``make'' to link the server.    See
  358. /usr/X11R6/lib/Server/README for more info.
  359.  
  360. See INSTALL for instructions on unbundling and building the source distribu-
  361. tion.
  362.  
  363. You should configure the distribution by editing xc/config/cf/xf86site.def
  364. before compiling.  To compile the sources, invoke ``make World'' in the xc
  365. directory.
  366.  
  367. 8.1  Console drivers
  368.  
  369. XFree86 3.3.1 has a configuration option to select the console drivers to use
  370. in xf86site.def:
  371.  
  372.    o  if you're using pccons put:
  373.  
  374.        #define XFree86ConsoleDefines -DPCCONS_SUPPORT
  375.  
  376.    o if you're using pcvt put:
  377.  
  378.        #define XFree86ConsoleDefines -DPCVT_SUPPORT
  379.  
  380.    o if you're using syscons put:
  381.  
  382.        #define XFree86ConsoleDefines -DSYSCONS_SUPPORT
  383.  
  384.    o if you're running codrv put:
  385.  
  386.        #define XFree86ConsoleDefines -DCODRV_SUPPORT
  387.  
  388.  
  389. If you don't define XFree86ConsoleDefines in xf86site.def the pccons and pcvt
  390. drivers will be supported.
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. README for XFree86 3.3.1 on OpenBSD
  401.  
  402.  
  403.  
  404. 8.2  console.h and ioctl_pc.h files:
  405.  
  406. If you want to build a server supporting codrv and you don't already have the
  407. corresponding header file ioctl_pc.h installed in /usr/include/machine, then
  408. install the copy that is supplied in xc/programs/Xserver/hw/xfree86/etc.  If
  409. you run OpenBSD-current you probably want to install it in
  410. /usr/src/sys/arch/i386/include too, so that it get reinstalled each time you
  411. run make includes.
  412.  
  413. If you have installed the  codrv console driver, this file should be taken from
  414. your installed version of the driver.
  415.  
  416. The console.h file for syscons isn't distributed with XFree86 anymore. You
  417. should get it from the syscons distribution.
  418.  
  419. 8.3  Building on other architectures
  420.  
  421. XFree86 3.3.1 also compiles on other OpenBSD architectures.
  422.  
  423. The XFree86 servers can also been built on OpenBSD/mips. The S3 server has been
  424. tested on an Acer Mips system with a S3/928 board. Contact Per Fogelstrom
  425. (pefo@OpenBSD.org) for details.
  426.  
  427. The Xsun server patches from Dennis Ferguson and Matthew Green for NetBSD have
  428. been integrated in xc/programs/Xserver/hw/sun. The Xsun server can be built on
  429. the sparc and the sun3.
  430.  
  431. The client side of XFree86 also builds on the alpha, pmax, amiga, mac68k and
  432. mvme68k architectures.
  433.  
  434. Problems with this port should be reported directly to the OpenBSD mailing
  435. lists rather than to the xfree86 mailing list.
  436.  
  437.  
  438. 9.  Building New X Clients
  439.  
  440. The easiest way to build a new client (X application) is to use xmkmf if an
  441. Imakefile is included in the sources.  Type ``xmkmf -a'' to create the Make-
  442. files, check the configuration if necessary and type ``make''.    Whenever you
  443. install additional man pages you should update whatis.db by running ``make-
  444. whatis /usr/X11R6/man''.
  445.  
  446. To avoid the ``Virtual memory exhausted'' message from cc while compiling,
  447. increase the data and stack size limits (in csh type ``limit datasize 32M'' and
  448. ``limit stacksize 16M'').
  449.  
  450.  
  451. 10.  Thanks
  452.  
  453. Many thanks to:
  454.  
  455.    o Pace Willison for providing the initial port to 386BSD.
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. README for XFree86 3.3.1 on OpenBSD
  467.  
  468.  
  469.  
  470.    o Amancio Hasty for fixing cursor restoration, mouse bugs and many others.
  471.  
  472.    o Christoph Robitschko for fixing com.c and thus select().
  473.  
  474.    o Nate Williams for the patchkit support for X.
  475.  
  476.    o Rod Grimes and Jack Velte of Walnut Creek Cdrom for use of their machines
  477.      in preparing the FreeBSD binary release.
  478.  
  479.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OpenBSD.sgml,v 1.1.2.2 1997/08/02 13:48:14 dawes Exp $
  480.  
  481.  
  482.  
  483.  
  484.  
  485.      $XConsortium$
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. README for XFree86 3.3.1 on OpenBSD
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.                    CONTENTS
  603.  
  604.  
  605.  
  606. 1.  What and Where is XFree86? .............................................. 1
  607.  
  608. 2.  Bug Reports for This Document ........................................... 1
  609.  
  610. 3.  New features in this release ............................................ 1
  611.  
  612. 4.  Installing the Binaries ................................................. 1
  613.     4.1 Installing Xdm, the display manager ................................. 1
  614.  
  615. 5.  Configuring X for Your Hardware ......................................... 2
  616.     5.1 About mouse configuration ........................................... 3
  617.     5.2 Other input devices ................................................. 3
  618.     5.3 Configuring PEX and XIE extensions .................................. 3
  619.  
  620. 6.  Running X ............................................................... 4
  621.  
  622. 7.  Kernel Support for X .................................................... 4
  623.     7.1 Aperture Driver ..................................................... 4
  624.     7.2 MIT-SHM ............................................................. 5
  625.  
  626. 8.  Rebuilding the XFree86 Distribution ..................................... 6
  627.     8.1 Console drivers ..................................................... 6
  628.     8.2 console.h and ioctl_pc.h files: ..................................... 7
  629.     8.3 Building on other architectures ..................................... 7
  630.  
  631. 9.  Building New X Clients .................................................. 7
  632.  
  633. 10. Thanks .................................................................. 7
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.                        i
  659.  
  660.  
  661.